import Runloop from '@runloop/api-client';const client = new Runloop({ bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted});const mcpConfigView = await client.mcpConfigs.create({ allowed_tools: ['string'], endpoint: 'endpoint', name: 'name',});console.log(mcpConfigView.id);
import os
from runloop_api_client import Runloop
client = Runloop(
bearer_token=os.environ.get("RUNLOOP_API_KEY"), # This is the default and can be omitted
)
mcp_config_view = client.mcp_configs.create(
allowed_tools=["string"],
endpoint="endpoint",
name="name",
)
print(mcp_config_view.id)
[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.
POST
/
v1
/
mcp-configs
JavaScript
import Runloop from '@runloop/api-client';const client = new Runloop({ bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted});const mcpConfigView = await client.mcpConfigs.create({ allowed_tools: ['string'], endpoint: 'endpoint', name: 'name',});console.log(mcpConfigView.id);
import os
from runloop_api_client import Runloop
client = Runloop(
bearer_token=os.environ.get("RUNLOOP_API_KEY"), # This is the default and can be omitted
)
mcp_config_view = client.mcp_configs.create(
allowed_tools=["string"],
endpoint="endpoint",
name="name",
)
print(mcp_config_view.id)
The human-readable name for the McpConfig. Names are labels and may be reused. The first segment before '-' is used as the service name for tool routing (e.g., 'github-readonly' uses 'github' as the service name).
Glob patterns specifying which tools are allowed from this MCP server. Examples: [''] for all tools, ['github.search_', 'github.get_*'] for specific patterns.
How the primary credential is applied to upstream requests. Defaults to 'bearer'.
Show child attributes
Response
McpConfig created successfully.
An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.
Additional headers applied to upstream requests after the credential. Secret-backed entries reference the secret by 'sec_' id; values are never returned.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Runloop AI Docs","colors":{"primary":"#118362","light":"#118362","dark":"#118362"},"logo":{"light":"https://mintcdn.com/runloopai/Us2eHV2_UnUki3-j/logo/runloop-logo.png?fit=max\u0026auto=format\u0026n=Us2eHV2_UnUki3-j\u0026q=85\u0026s=f3caaf67e1c45f535be611579f752bad","dark":"https://mintcdn.com/runloopai/Us2eHV2_UnUki3-j/logo/runloop-logo.png?fit=max\u0026auto=format\u0026n=Us2eHV2_UnUki3-j\u0026q=85\u0026s=f3caaf67e1c45f535be611579f752bad","href":"https://runloop.ai"},"favicon":"https://mintcdn.com/runloopai/fWPbnslqIgBTzYjS/icon.svg?fit=max\u0026auto=format\u0026n=fWPbnslqIgBTzYjS\u0026q=85\u0026s=42689e938126fab53c09e6aefd2125a7","appearance":{"default":"dark"},"background":{"color":{"light":"#F9F9F9","dark":"#191B2E"}},"navbar":{"links":[{"href":"mailto:support@runloop.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.runloop.ai"}},"footer":{"socials":{"github":"https://github.com/runloopai","linkedin":"https://www.linkedin.com/company/runloopai","youtube":"https://www.youtube.com/@runloop-ai","x":"https://x.com/RunloopAI"}},"fonts":{"family":"Inter"},"styling":{"latex":false},"integrations":{"gtm":{"tagId":"G-DHKMJC9ETL"},"mixpanel":{"projectToken":"332c39ec74c2f00fba90d9e5cfd67791"},"posthog":{"apiKey":"phc_vW06f31Rk74Ey1ZbIS8Mfxx4oIQA3fIxTVn29qVr42c","sessionRecording":true}},"banner":{"content":"Runloop is winding down its services. Support for existing customers continues through November 13, 2026 at 11:59 PM PT. [Transition guides](/docs/transitions/overview).","dismissible":false},"contextual":{"options":["chatgpt","claude","copy"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"runloopai","hasAudioNarration":false,"actualSubdomain":"runloopai","customDomains":["docs.runloop.ai"],"gitSource":{"type":"github","owner":"runloopai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6add1e0f29f48133ead15d81","collectionId":"90fcf6c3-4dd4-4d17-8ab9-583c417733c2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6add1e0f29f48133ead15d81"},"feedback":{"edits":false,"thumbs":true,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6add1e0f29f48133ead15d81","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":106},{"language":"default","tag":"Documentation","count":70},{"language":"default","tag":"Devbox","count":44},{"language":"default","tag":"Components","count":41},{"language":"default","tag":"Devboxes","count":22},{"language":"default","tag":"Overview","count":16},{"language":"default","tag":"axons","count":12},{"language":"default","tag":"Blueprint","count":11},{"language":"default","tag":"objects","count":9},{"language":"default","tag":"Transitions","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"theme.css","content":"code,pre{font-size:.85rem!important;line-height:1.4!important}"}],"page":{"pagePath":"api-reference/mcp-configs/[beta]-create-an-mcpconfig","slug":"/api-reference/mcp-configs/[beta]-create-an-mcpconfig","pageMetadata":{"title":"[Beta] Create an McpConfig.","description":"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/mcp-configs","href":"/api-reference/mcp-configs/[beta]-create-an-mcpconfig","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"[Beta] Create an McpConfig.","description":"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/mcp-configs","href":"/api-reference/mcp-configs/[beta]-create-an-mcpconfig","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/runloopai/70ccb22e7cd1529e/scripts/generate-changelog.js","/_mintlify/custom/runloopai/6440a26b64c8b606/scripts/generate-llms-index.js"],"openApiReferenceData":{"operation":{"tags":["mcp-configs"],"summary":"[Beta] Create an McpConfig.","description":"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.","operationId":"createMcpConfig","requestBody":"7a7bd722-4180-4b2a-bd09-61f1b65261f6","responses":{"200":"ebeea4ce-2a8b-48ac-8c7f-af30dc86427d","400":"a3d5afbe-00be-4f83-8964-c6d14d91422b","401":"39737665-3c91-4c25-9b09-8f36fa384757","403":"a0e490d2-1ac8-4c09-941a-55cbf82ef65a","500":"5cee1356-1747-4c43-bfe6-19115b4df99f"},"x-codeSamples":[{"lang":"JavaScript","source":"import Runloop from '@runloop/api-client';\n\nconst client = new Runloop({\n bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted\n});\n\nconst mcpConfigView = await client.mcpConfigs.create({\n allowed_tools: ['string'],\n endpoint: 'endpoint',\n name: 'name',\n});\n\nconsole.log(mcpConfigView.id);"},{"lang":"Python","source":"import os\nfrom runloop_api_client import Runloop\n\nclient = Runloop(\n bearer_token=os.environ.get(\"RUNLOOP_API_KEY\"), # This is the default and can be omitted\n)\nmcp_config_view = client.mcp_configs.create(\n allowed_tools=[\"string\"],\n endpoint=\"endpoint\",\n name=\"name\",\n)\nprint(mcp_config_view.id)"}],"method":"post","type":"path","servers":["1d631bad-0fd6-4617-a8c4-8377826d815d"],"security":["8ce27edf-f079-415e-937e-65fded4f9d46"],"path":"/v1/mcp-configs","baseUrlOptions":["https://api.runloop.ai"],"title":"[Beta] Create an McpConfig.","codeSamples":[{"lang":"JavaScript","source":"import Runloop from '@runloop/api-client';\n\nconst client = new Runloop({\n bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted\n});\n\nconst mcpConfigView = await client.mcpConfigs.create({\n allowed_tools: ['string'],\n endpoint: 'endpoint',\n name: 'name',\n});\n\nconsole.log(mcpConfigView.id);"},{"lang":"Python","source":"import os\nfrom runloop_api_client import Runloop\n\nclient = Runloop(\n bearer_token=os.environ.get(\"RUNLOOP_API_KEY\"), # This is the default and can be omitted\n)\nmcp_config_view = client.mcp_configs.create(\n allowed_tools=[\"string\"],\n endpoint=\"endpoint\",\n name=\"name\",\n)\nprint(mcp_config_view.id)"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Parameters required to create a new McpConfig.","properties":{"name":{"type":"string","description":"The human-readable name for the McpConfig. Names are labels and may be reused. The first segment before '-' is used as the service name for tool routing (e.g., 'github-readonly' uses 'github' as the service name).","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"endpoint":{"type":"string","description":"The target MCP server endpoint URL (e.g., 'https://mcp.example.com').","isRequired":true,"uniqueKey":"endpoint","typeLabel":"string"},"allowed_tools":{"type":"array","items":{"type":"string","uniqueKey":"allowed_tools.items.[INDEX]","typeLabel":"string"},"description":"Glob patterns specifying which tools are allowed from this MCP server. Examples: ['*'] for all tools, ['github.search_*', 'github.get_*'] for specific patterns.","isRequired":true,"uniqueKey":"allowed_tools","typeLabel":"string[]"},"description":{"oneOf":[{"description":"Optional description for this MCP configuration.","type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"description":"Optional description for this MCP configuration.","type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"custom_headers":{"oneOf":[{"items":{"type":"object","description":"An additional header applied to upstream requests alongside the primary credential. The value comes from an account secret or a literal string; exactly one of 'secret' and 'value' must be set.","properties":{"name":{"type":"string","description":"The header name (e.g., 'DD-APPLICATION-KEY').","isRequired":true,"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].name","typeLabel":"string"},"secret":{"oneOf":[{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"string","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret.oneOf.0","typeLabel":"string"},{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"null","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret","typeLabel":"string | null"},"value":{"oneOf":[{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"string","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"null","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value","typeLabel":"string | null"}},"required":["name"],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Additional headers applied to upstream requests after the credential. At most 8 entries.","type":"array","uniqueKey":"custom_headers.oneOf.0","typeLabel":"object[]"},{"items":{"type":"object","description":"An additional header applied to upstream requests alongside the primary credential. The value comes from an account secret or a literal string; exactly one of 'secret' and 'value' must be set.","properties":{"name":{"type":"string","description":"The header name (e.g., 'DD-APPLICATION-KEY')."},"secret":{"oneOf":[{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"string"},{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"null"}]},"value":{"oneOf":[{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"string"},{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"null"}]}},"required":["name"]},"description":"Additional headers applied to upstream requests after the credential. At most 8 entries.","type":"null","uniqueKey":"custom_headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers","typeLabel":"object[] | null"},"auth_mechanism":{"oneOf":[{"type":"object","description":"How the primary credential is applied to upstream requests. Defaults to 'bearer'.","required":["type"],"properties":{"type":{"type":"string","description":"The type of authentication mechanism: 'header', 'bearer', or 'basic'. For 'basic', store the secret as plain 'user:pass'; the proxy base64-encodes it.","isRequired":true,"uniqueKey":"auth_mechanism.oneOf.0.type","typeLabel":"string"},"key":{"oneOf":[{"description":"The header name (e.g., 'x-api-key'). Required for 'header' type; invalid for other types.","type":"string","uniqueKey":"auth_mechanism.oneOf.0.key.oneOf.0","typeLabel":"string"},{"description":"The header name (e.g., 'x-api-key'). Required for 'header' type; invalid for other types.","type":"null","uniqueKey":"auth_mechanism.oneOf.0.key.oneOf.1","typeLabel":"null"}],"uniqueKey":"auth_mechanism.oneOf.0.key","typeLabel":"string | null"}},"uniqueKey":"auth_mechanism.oneOf.0","typeLabel":"object"},{"type":"null","description":"How the primary credential is applied to upstream requests. Defaults to 'bearer'.","uniqueKey":"auth_mechanism.oneOf.1","typeLabel":"null"}],"uniqueKey":"auth_mechanism","typeLabel":"object | null"}},"required":["name","endpoint","allowed_tools"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","endpoint":"\u003cstring>","allowed_tools":["\u003cstring>"],"description":"\u003cstring>","custom_headers":[{"name":"\u003cstring>","secret":"\u003cstring>","value":"\u003cstring>"}],"auth_mechanism":{"type":"\u003cstring>","key":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ebeea4ce-2a8b-48ac-8c7f-af30dc86427d":{"description":"McpConfig created successfully.","content":{"application/json":{"schema":{"type":"object","description":"An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.","properties":{"id":{"type":"string","description":"The unique identifier of the McpConfig.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","description":"The human-readable name of the McpConfig. Names may be reused.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"endpoint":{"type":"string","description":"The target MCP server endpoint URL (e.g., 'https://mcp.example.com').","isRequired":true,"uniqueKey":"endpoint","typeLabel":"string"},"allowed_tools":{"type":"array","items":{"type":"string","uniqueKey":"allowed_tools.items.[INDEX]","typeLabel":"string"},"description":"Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_*', 'github.get_*'] or ['*'] for all tools).","isRequired":true,"uniqueKey":"allowed_tools","typeLabel":"string[]"},"auth_mechanism":{"type":"object","description":"How the primary credential is applied to upstream requests.","properties":{"type":{"type":"string","description":"The type of authentication mechanism: 'header', 'bearer', or 'basic'. For 'basic', store the secret as plain 'user:pass'; the proxy base64-encodes it.","isRequired":true,"uniqueKey":"auth_mechanism.type","typeLabel":"string"},"key":{"oneOf":[{"description":"The header name (e.g., 'x-api-key'). Required for 'header' type; invalid for other types.","type":"string","uniqueKey":"auth_mechanism.key.oneOf.0","typeLabel":"string"},{"description":"The header name (e.g., 'x-api-key'). Required for 'header' type; invalid for other types.","type":"null","uniqueKey":"auth_mechanism.key.oneOf.1","typeLabel":"null"}],"uniqueKey":"auth_mechanism.key","typeLabel":"string | null"}},"required":["type"],"isRequired":true,"uniqueKey":"auth_mechanism","typeLabel":"object"},"create_time_ms":{"type":"integer","format":"int64","description":"Creation time of the McpConfig (Unix timestamp in milliseconds).","isRequired":true,"uniqueKey":"create_time_ms","typeLabel":"integer\u003cint64>"},"description":{"oneOf":[{"description":"Optional description for this MCP configuration.","type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"description":"Optional description for this MCP configuration.","type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"custom_headers":{"oneOf":[{"items":{"type":"object","description":"An additional header applied to upstream requests alongside the primary credential. The value comes from an account secret or a literal string; exactly one of 'secret' and 'value' must be set.","properties":{"name":{"type":"string","description":"The header name (e.g., 'DD-APPLICATION-KEY').","isRequired":true,"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].name","typeLabel":"string"},"secret":{"oneOf":[{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"string","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret.oneOf.0","typeLabel":"string"},{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"null","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].secret","typeLabel":"string | null"},"value":{"oneOf":[{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"string","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"null","uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX].value","typeLabel":"string | null"}},"required":["name"],"uniqueKey":"custom_headers.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Additional headers applied to upstream requests after the credential. Secret-backed entries reference the secret by 'sec_' id; values are never returned.","type":"array","uniqueKey":"custom_headers.oneOf.0","typeLabel":"object[]"},{"items":{"type":"object","description":"An additional header applied to upstream requests alongside the primary credential. The value comes from an account secret or a literal string; exactly one of 'secret' and 'value' must be set.","properties":{"name":{"type":"string","description":"The header name (e.g., 'DD-APPLICATION-KEY')."},"secret":{"oneOf":[{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"string"},{"description":"Account secret providing the header value. Accepts a secret name or 'sec_' id on writes; reads always return the 'sec_' id.","type":"null"}]},"value":{"oneOf":[{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"string"},{"description":"Literal header value. Stored in plaintext and returned by reads - use 'secret' for credentials or other sensitive values.","type":"null"}]}},"required":["name"]},"description":"Additional headers applied to upstream requests after the credential. Secret-backed entries reference the secret by 'sec_' id; values are never returned.","type":"null","uniqueKey":"custom_headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_headers","typeLabel":"object[] | null"}},"required":["id","name","endpoint","allowed_tools","auth_mechanism","create_time_ms"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","endpoint":"\u003cstring>","allowed_tools":["\u003cstring>"],"auth_mechanism":{"type":"\u003cstring>","key":"\u003cstring>"},"create_time_ms":123,"description":"\u003cstring>","custom_headers":[{"name":"\u003cstring>","secret":"\u003cstring>","value":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a3d5afbe-00be-4f83-8964-c6d14d91422b":{"description":"Bad request. Name, endpoint, or auth mechanism is invalid.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"39737665-3c91-4c25-9b09-8f36fa384757":{"description":"Unauthorized. Invalid or missing authentication.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a0e490d2-1ac8-4c09-941a-55cbf82ef65a":{"description":"Forbidden. Account does not have devbox capability.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"5cee1356-1747-4c43-bfe6-19115b4df99f":{"description":"Internal server error.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"8ce27edf-f079-415e-937e-65fded4f9d46":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1d631bad-0fd6-4617-a8c4-8377826d815d":{"url":"https://api.runloop.ai","description":"Runloop API","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi-specs/stainless-processed-openapi.json"},"subdomain":"runloopai","siteName":"Runloop AI Docs","title":"[Beta] Create an McpConfig. - Runloop AI Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-24T21:07:34.864Z","originalFileLocation":"api-reference/mcp-configs/[beta]-create-an-mcpconfig.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Runloop AI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"[Beta] Create an McpConfig. - Runloop AI Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Runloop AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://runloopai.mintlify.app/_mintlify/api/og/v2?division=mcp-configs\u0026amp;title=%5BBeta%5D+Create+an+McpConfig.\u0026amp;description=%5BBeta%5D+Create+a+new+McpConfig+to+connect+to+an+upstream+MCP+%28Model+Context+Protocol%29+server.+The+config+specifies+the+target+endpoint+and+which+tools+are+allowe\u0026amp;theme=640224b746a7c52ddd40c033\u0026amp;signature=21c5bd2d93c3411aab1de31db9d3d2e844909a4c25acd04eca0c1cbdb9d56a4a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"[Beta] Create an McpConfig. - Runloop AI Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://runloopai.mintlify.app/_mintlify/api/og/v2?division=mcp-configs\u0026amp;title=%5BBeta%5D+Create+an+McpConfig.\u0026amp;description=%5BBeta%5D+Create+a+new+McpConfig+to+connect+to+an+upstream+MCP+%28Model+Context+Protocol%29+server.+The+config+specifies+the+target+endpoint+and+which+tools+are+allowe\u0026amp;theme=640224b746a7c52ddd40c033\u0026amp;signature=21c5bd2d93c3411aab1de31db9d3d2e844909a4c25acd04eca0c1cbdb9d56a4a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/runloopai/pjXnHMZq1DfDYUjd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Runloop AI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#118362\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/mcp-configs/%5Bbeta%5D-create-an-mcpconfig.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.runloop.ai/#organization\",\"name\":\"Runloop AI Docs\",\"url\":\"https://docs.runloop.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/runloopai/Us2eHV2_UnUki3-j/logo/runloop-logo.png?fit=max\u0026auto=format\u0026n=Us2eHV2_UnUki3-j\u0026q=85\u0026s=f3caaf67e1c45f535be611579f752bad\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.runloop.ai#website\",\"name\":\"Runloop AI Docs\",\"url\":\"https://docs.runloop.ai\",\"publisher\":{\"@id\":\"https://docs.runloop.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig#webpage\",\"url\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig\",\"name\":\"[Beta] Create an McpConfig.\",\"description\":\"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\",\"dateModified\":\"2026-10-24T21:07:34.864Z\",\"isPartOf\":{\"@id\":\"https://docs.runloop.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"mcp-configs\",\"item\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-list-mcpconfigs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"[Beta] Create an McpConfig.\",\"item\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig#apireference\",\"headline\":\"[Beta] Create an McpConfig.\",\"name\":\"[Beta] Create an McpConfig.\",\"description\":\"[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.\",\"url\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig\",\"mainEntityOfPage\":{\"@id\":\"https://docs.runloop.ai/api-reference/mcp-configs/[beta]-create-an-mcpconfig#webpage\"},\"dateModified\":\"2026-10-24T21:07:34.864Z\",\"publisher\":{\"@id\":\"https://docs.runloop.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.runloop.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Runloop AI Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Runloop AI Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/overview/what-is-runloop"}]},{"tab":"API Reference","groups":[{"group":"Devbox","pages":[{"title":"Create or reconnect to a PTY session.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /pty/{session_name}","href":"/api-reference/devbox/create-or-reconnect-to-a-pty-session"},{"title":"Send a control command to a PTY session.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /pty/{session_name}/control","href":"/api-reference/devbox/send-a-control-command-to-a-pty-session"},{"title":"List Devboxes.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes","href":"/api-reference/devbox/list-devboxes"},{"title":"Create a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes","href":"/api-reference/devbox/create-a-devbox"},{"title":"List disk snapshots of a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots","href":"/api-reference/devbox/list-disk-snapshots-of-a-devbox"},{"title":"List public disk snapshots.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/list_public","href":"/api-reference/devbox/list-public-disk-snapshots"},{"title":"List available snapshot metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/metadata/keys","href":"/api-reference/devbox/list-available-snapshot-metadata-keys"},{"title":"List values for a specific snapshot metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/metadata/keys/{key}/values","href":"/api-reference/devbox/list-values-for-a-specific-snapshot-metadata-key"},{"title":"List available public snapshot metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/public/metadata/keys","href":"/api-reference/devbox/list-available-public-snapshot-metadata-keys"},{"title":"List values for a specific public snapshot metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/public/metadata/keys/{key}/values","href":"/api-reference/devbox/list-values-for-a-specific-public-snapshot-metadata-key"},{"title":"Update metadata of Disk Snapshot.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/disk_snapshots/{id}","href":"/api-reference/devbox/update-metadata-of-disk-snapshot"},{"title":"Delete a disk snapshot of a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/disk_snapshots/{id}/delete","href":"/api-reference/devbox/delete-a-disk-snapshot-of-a-devbox"},{"title":"Query the status of an asynchronous disk snapshot.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/disk_snapshots/{id}/status","href":"/api-reference/devbox/query-the-status-of-an-asynchronous-disk-snapshot"},{"title":"List available devbox metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/metadata/keys","href":"/api-reference/devbox/list-available-devbox-metadata-keys"},{"title":"List values for a specific devbox metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/metadata/keys/{key}/values","href":"/api-reference/devbox/list-values-for-a-specific-devbox-metadata-key"},{"title":"Get status of an asynchronous execution on a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{devbox_id}/executions/{execution_id}","href":"/api-reference/devbox/get-status-of-an-asynchronous-execution-on-a-devbox"},{"title":"Kill an asynchronous execution currently running on a devbox","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{devbox_id}/executions/{execution_id}/kill","href":"/api-reference/devbox/kill-an-asynchronous-execution-currently-running-on-a-devbox"},{"title":"Send Content to Std In for a running execution.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{devbox_id}/executions/{execution_id}/send_std_in","href":"/api-reference/devbox/send-content-to-std-in-for-a-running-execution"},{"title":"Wait for an asynchronous execution to reach a specific status.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{devbox_id}/executions/{execution_id}/wait_for_status","href":"/api-reference/devbox/wait-for-an-asynchronous-execution-to-reach-a-specific-status"},{"title":"Get Devbox details.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{id}","href":"/api-reference/devbox/get-devbox-details"},{"title":"Update a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}","href":"/api-reference/devbox/update-a-devbox"},{"title":"Mint an agent gateway token for a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/create_gateway_token","href":"/api-reference/devbox/mint-an-agent-gateway-token-for-a-devbox"},{"title":"[Beta] Mint an MCP token for a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/create_mcp_token","href":"/api-reference/devbox/[beta]-mint-an-mcp-token-for-a-devbox"},{"title":"Create an ephemeral PTY tunnel for a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/create_pty_tunnel","href":"/api-reference/devbox/create-an-ephemeral-pty-tunnel-for-a-running-devbox"},{"title":"Create an SSH key for a Devbox","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/create_ssh_key","href":"/api-reference/devbox/create-an-ssh-key-for-a-devbox"},{"title":"Download binary file contents from Devbox filesystem.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/download_file","href":"/api-reference/devbox/download-binary-file-contents-from-devbox-filesystem"},{"title":"Enable a tunnel for a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/enable_tunnel","href":"/api-reference/devbox/enable-a-tunnel-for-a-running-devbox"},{"title":"Execute a command with a known ID, optimistically waiting for completion","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/execute","href":"/api-reference/devbox/execute-a-command-with-a-known-id-optimistically-waiting-for-completion"},{"title":"Asynchronously execute a command via the Devbox shell","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/execute_async","href":"/api-reference/devbox/asynchronously-execute-a-command-via-the-devbox-shell"},{"title":"(Deprecated, please use /execute_async) Synchronously execute a shell command on a Devbox","deprecated":true,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/execute_sync","href":"/api-reference/devbox/deprecated-please-use-execute_async-synchronously-execute-a-shell-command-on-a-devbox"},{"title":"Reset the idle timer of a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/keep_alive","href":"/api-reference/devbox/reset-the-idle-timer-of-a-running-devbox"},{"title":"Get Devbox logs.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{id}/logs","href":"/api-reference/devbox/get-devbox-logs"},{"title":"Live Tail Devbox Logs.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{id}/logs/tail","href":"/api-reference/devbox/live-tail-devbox-logs"},{"title":"Read text file contents from Devbox filesystem.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/read_file_contents","href":"/api-reference/devbox/read-text-file-contents-from-devbox-filesystem"},{"title":"Remove a tunnel from the Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/remove_tunnel","href":"/api-reference/devbox/remove-a-tunnel-from-the-devbox"},{"title":"Resume a suspended Devbox","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/resume","href":"/api-reference/devbox/resume-a-suspended-devbox"},{"title":"Shutdown a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/shutdown","href":"/api-reference/devbox/shutdown-a-running-devbox"},{"title":"Synchronously create a disk snapshot of a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/snapshot_disk","href":"/api-reference/devbox/synchronously-create-a-disk-snapshot-of-a-running-devbox"},{"title":"Start an asynchronous disk snapshot of a running Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/snapshot_disk_async","href":"/api-reference/devbox/start-an-asynchronous-disk-snapshot-of-a-running-devbox"},{"title":"Suspend a running Devbox","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/suspend","href":"/api-reference/devbox/suspend-a-running-devbox"},{"title":"Upload binary file contents to Devbox filesystem.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/upload_file","href":"/api-reference/devbox/upload-binary-file-contents-to-devbox-filesystem"},{"title":"Get resource usage for a Devbox.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{id}/usage","href":"/api-reference/devbox/get-resource-usage-for-a-devbox"},{"title":"Wait for a Devbox to reach one of the specified statuses.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/wait_for_status","href":"/api-reference/devbox/wait-for-a-devbox-to-reach-one-of-the-specified-statuses"},{"title":"Write text file contents to Devbox filesystem.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/devboxes/{id}/write_file_contents","href":"/api-reference/devbox/write-text-file-contents-to-devbox-filesystem"}]},{"group":"accounts","pages":[{"title":"Get the authenticated caller's account.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/accounts/me","href":"/api-reference/accounts/get-the-authenticated-callers-account"}]},{"group":"apikeys","pages":[{"title":"Create API Key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/apikeys","href":"/api-reference/apikeys/create-api-key"}]},{"group":"axons","pages":[{"title":"[Beta] List axons.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons","href":"/api-reference/axons/[beta]-list-axons"},{"title":"[Beta] Create an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/axons","href":"/api-reference/axons/[beta]-create-an-axon"},{"title":"[Beta] List available axon metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons/metadata/keys","href":"/api-reference/axons/[beta]-list-available-axon-metadata-keys"},{"title":"[Beta] List values for a specific axon metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons/metadata/keys/{key}/values","href":"/api-reference/axons/[beta]-list-values-for-a-specific-axon-metadata-key"},{"title":"[Beta] Get an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons/{id}","href":"/api-reference/axons/[beta]-get-an-axon"},{"title":"[Beta] Update an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/axons/{id}","href":"/api-reference/axons/[beta]-update-an-axon"},{"title":"[Beta] Delete an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json delete /v1/axons/{id}","href":"/api-reference/axons/[beta]-delete-an-axon"},{"title":"[Beta] List events for an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons/{id}/events","href":"/api-reference/axons/[beta]-list-events-for-an-axon"},{"title":"[Beta] Publish an event to an axon.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/axons/{id}/publish","href":"/api-reference/axons/[beta]-publish-an-event-to-an-axon"},{"title":"[Beta] Execute a batch of SQL statements against an axon's database.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/axons/{id}/sql/batch","href":"/api-reference/axons/[beta]-execute-a-batch-of-sql-statements-against-an-axons-database"},{"title":"[Beta] Execute a SQL query against an axon's database.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/axons/{id}/sql/query","href":"/api-reference/axons/[beta]-execute-a-sql-query-against-an-axons-database"},{"title":"[Beta] Subscribe to an axon event stream via SSE.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/axons/{id}/subscribe/sse","href":"/api-reference/axons/[beta]-subscribe-to-an-axon-event-stream-via-sse"}]},{"group":"Blueprint","pages":[{"title":"List Blueprints.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints","href":"/api-reference/blueprint/list-blueprints"},{"title":"Create and build a Blueprint.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/blueprints","href":"/api-reference/blueprint/create-and-build-a-blueprint"},{"title":"List Public Blueprints.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/list_public","href":"/api-reference/blueprint/list-public-blueprints"},{"title":"List available blueprint metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/metadata/keys","href":"/api-reference/blueprint/list-available-blueprint-metadata-keys"},{"title":"List values for a specific blueprint metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/metadata/keys/{key}/values","href":"/api-reference/blueprint/list-values-for-a-specific-blueprint-metadata-key"},{"title":"Preview Dockerfile definition for a Blueprint.","deprecated":true,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/blueprints/preview","href":"/api-reference/blueprint/preview-dockerfile-definition-for-a-blueprint"},{"title":"List available public blueprint metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/public/metadata/keys","href":"/api-reference/blueprint/list-available-public-blueprint-metadata-keys"},{"title":"List values for a specific public blueprint metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/public/metadata/keys/{key}/values","href":"/api-reference/blueprint/list-values-for-a-specific-public-blueprint-metadata-key"},{"title":"Get a Blueprint.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/{id}","href":"/api-reference/blueprint/get-a-blueprint"},{"title":"Delete a Blueprint.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/blueprints/{id}/delete","href":"/api-reference/blueprint/delete-a-blueprint"},{"title":"Get Blueprint build logs.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/blueprints/{id}/logs","href":"/api-reference/blueprint/get-blueprint-build-logs"}]},{"group":"API Reference","pages":[{"title":"Stream infrastructure eviction warnings for the account via SSE.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/evictions/watch","href":"/api-reference/stream-infrastructure-eviction-warnings-for-the-account-via-sse"}]},{"group":"executions","pages":[{"title":"Tails the stderr logs for the given execution with SSE streaming","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stderr_updates","href":"/api-reference/executions/tails-the-stderr-logs-for-the-given-execution-with-sse-streaming"},{"title":"Tails the stdout logs for the given execution with SSE streaming","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/devboxes/{devbox_id}/executions/{execution_id}/stream_stdout_updates","href":"/api-reference/executions/tails-the-stdout-logs-for-the-given-execution-with-sse-streaming"}]},{"group":"gateway-configs","pages":[{"title":"List GatewayConfigs.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/gateway-configs","href":"/api-reference/gateway-configs/list-gatewayconfigs"},{"title":"Create a GatewayConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/gateway-configs","href":"/api-reference/gateway-configs/create-a-gatewayconfig"},{"title":"Get a GatewayConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/gateway-configs/{id}","href":"/api-reference/gateway-configs/get-a-gatewayconfig"},{"title":"Update a GatewayConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/gateway-configs/{id}","href":"/api-reference/gateway-configs/update-a-gatewayconfig"},{"title":"Delete a GatewayConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/gateway-configs/{id}/delete","href":"/api-reference/gateway-configs/delete-a-gatewayconfig"}]},{"group":"mcp-configs","pages":[{"title":"[Beta] List McpConfigs.","description":"[Beta] List all McpConfigs for the authenticated account.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/mcp-configs","href":"/api-reference/mcp-configs/[beta]-list-mcpconfigs"},{"title":"[Beta] Create an McpConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/mcp-configs","href":"/api-reference/mcp-configs/[beta]-create-an-mcpconfig"},{"title":"[Beta] Get an McpConfig.","description":"[Beta] Get a specific McpConfig by its unique identifier.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/mcp-configs/{id}","href":"/api-reference/mcp-configs/[beta]-get-an-mcpconfig"},{"title":"[Beta] Update an McpConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/mcp-configs/{id}","href":"/api-reference/mcp-configs/[beta]-update-an-mcpconfig"},{"title":"[Beta] Delete an McpConfig.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/mcp-configs/{id}/delete","href":"/api-reference/mcp-configs/[beta]-delete-an-mcpconfig"}]},{"group":"network-policies","pages":[{"title":"List NetworkPolicies.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/network-policies","href":"/api-reference/network-policies/list-networkpolicies"},{"title":"Create a NetworkPolicy.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/network-policies","href":"/api-reference/network-policies/create-a-networkpolicy"},{"title":"Get a NetworkPolicy.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/network-policies/{id}","href":"/api-reference/network-policies/get-a-networkpolicy"},{"title":"Update a NetworkPolicy.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/network-policies/{id}","href":"/api-reference/network-policies/update-a-networkpolicy"},{"title":"Delete a NetworkPolicy.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/network-policies/{id}/delete","href":"/api-reference/network-policies/delete-a-networkpolicy"}]},{"group":"objects","pages":[{"title":"List Objects.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects","href":"/api-reference/objects/list-objects"},{"title":"Create an Object.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/objects","href":"/api-reference/objects/create-an-object"},{"title":"List Public Objects.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects/list_public","href":"/api-reference/objects/list-public-objects"},{"title":"List available object metadata keys.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects/metadata/keys","href":"/api-reference/objects/list-available-object-metadata-keys"},{"title":"List values for a specific object metadata key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects/metadata/keys/{key}/values","href":"/api-reference/objects/list-values-for-a-specific-object-metadata-key"},{"title":"Get an Object.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects/{id}","href":"/api-reference/objects/get-an-object"},{"title":"Complete Object Upload.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/objects/{id}/complete","href":"/api-reference/objects/complete-object-upload"},{"title":"Delete an Object.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/objects/{id}/delete","href":"/api-reference/objects/delete-an-object"},{"title":"Generate Download URL for Object.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/objects/{id}/download","href":"/api-reference/objects/generate-download-url-for-object"}]},{"group":"restricted_keys","pages":[{"title":"Create a restricted API key.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/restricted_keys","href":"/api-reference/restricted_keys/create-a-restricted-api-key"}]},{"group":"secrets","pages":[{"title":"List Secrets.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/secrets","href":"/api-reference/secrets/list-secrets"},{"title":"Create a Secret.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/secrets","href":"/api-reference/secrets/create-a-secret"},{"title":"Get a Secret by ID.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/secrets/id/{id}","href":"/api-reference/secrets/get-a-secret-by-id"},{"title":"Delete a Secret by ID.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/secrets/id/{id}/delete","href":"/api-reference/secrets/delete-a-secret-by-id"},{"title":"Update a Secret by ID.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/secrets/id/{id}/update","href":"/api-reference/secrets/update-a-secret-by-id"},{"title":"Get a Secret.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json get /v1/secrets/{name}","href":"/api-reference/secrets/get-a-secret"},{"title":"Update a Secret.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/secrets/{name}","href":"/api-reference/secrets/update-a-secret"},{"title":"Delete a Secret.","deprecated":null,"version":null,"openapi":"/openapi-specs/stainless-processed-openapi.json post /v1/secrets/{name}/delete","href":"/api-reference/secrets/delete-a-secret"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/overview/release-notes"}]}]},"basePath":"","title":"[Beta] Create an McpConfig. - Runloop AI Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DHaG7hr_.js","dist-DKZWslLH.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-BIWXJmsZ.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","AssistantPageLink-UDqbR6xh.js"]}